HCOPy...    Related Topics

The HCOPy system controls the output of screen information to an external device. Part of the functionality of this system is included in the File menu.

 

Command tree: HCOPy

:DESTination

:DEVice

:LANGuage

[:IMMediate]

:ITEM

:ALL

:LOGO

[:STATe]

:MLISt

[:STATe]

:TIME

[:STATe]

:PAGE

:MARGin

:BOTTom

:LEFT

:RIGHt

:TOP

:ORIentation

:WINDow

HCOPy:DESTination <string> | 'MMEM'

Selects a printer name or file as destination for the screen output.

<string> |

Printer name, string variable. One of the printers accessible from your PC.

 

'MMEM'

Print to file. The file name is defined via MMEMory:NAME. The command HCOPy:DEVice:LANGuage WMF | EWMF | BMP | PNG selects the file format.

*RST value

–

Note: *RST does not overwrite the printer destination.  

 

SCPI, Command Types

Confirmed, command or query.

 

Example:

MMEM:NAME 'C:\Screenshots\PLOT1.BMP'

Define a printer file name (without creating the file), assuming that .BMP is the current file format (see HCOPy:DEVice:LANGuage).

HCOP:DEST 'MMEM'; HCOP

Select 'Print to file' and create the printer file specified before.

 

 

HCOPy:DEVice:LANGuage
EMF | WMF | EWMF | BMP | JPG | PNG

Selects a file format for printer files. Selecting the format is recommended to ensure that the file defined via MMEMory:NAME can be read or imported by an external application.

EMF, WMF, EWMF

Windows enhanced metafile format (vector-based, file extension *.emf). The parameter WMF is equivalent to EMF; a query returns EMF.

BMP

Windows bitmap

JPG

JPEG bitmap

PNG

Portable network graphics format

*RST value

BMP

 

SCPI, Command Types

Confirmed, command or query.

 

Example:

HCOP:DEV:LANG BMP

Select Windows bitmap format for printer files.

MMEM:NAME 'C:\Screenshots\PLOT1.BMP'

Define a printer file name and specify an existing directory (without creating the file).

HCOP:DEST 'MMEM'; HCOP

Select 'Print to file' and create the printer file specified before.

 

HCOPy[:IMMediate]

Immediately initializes the print according to the current HCOPy setup parameters.

*RST value

–

 

SCPI, Command Types

Confirmed, no query.

 

Example:

HCOP:DEST '<Printer_name>'

Select the printer for the output of screen data.

HCOP

Start printing.

 

HCOPy:ITEM:ALL

Selects the complete screen contents to be printed, including the logo (HCOPy:ITEM:LOGO), time (HCOPy:ITEM:TIME), and the marker list (HCOPy:ITEM:MLISt).

*RST value

After a reset, the complete information is printed; see commands for logo, time, marker list and settings.

 

SCPI, Command Types

Confirmed, no query.  

 

Example:

HCOP:ITEM:ALL

Select the complete information to be printed.

HCOP

Start printing.

 

HCOPy:ITEM:LOGO[:STATe] <Boolean>

Qualifies whether or not the printed output contains the logo. The default R&S logo (file Logo.gif) is stored in the Resources\Images subdirectory of the NWA program directory and can be replaced by another logo.

<Boolean>

ON | OFF - Logo is included or excluded.

*RST value

OFF

 

SCPI, Command Types

Device-specific, command or query

 

Example:

HCOP:ITEM:ALL

Select the complete information to be printed.

HCOP:ITEM:LOGO ON; HCOP

Include the logo in the printed output and start printing.

 

HCOPy:ITEM:MLISt[:STATe] <Boolean>

Qualifies whether or not the printed output contains the information in the marker info field (marker list).

<Boolean>

ON | OFF - Marker list is included or excluded.

*RST value

OFF

 

SCPI, Command Types

Device-specific, command or query

 

Example:

HCOP:ITEM:ALL

Select the complete information to be printed.

HCOP:ITEM:MLISt ON; HCOP

Include the marker list in the printed output and start printing.

 

HCOPy:ITEM:TIME[:STATe] <Boolean>

Qualifies whether or not the printed output contains the current date and time.

<Boolean>

ON | OFF - Date and time is included or excluded.

*RST value

OFF

 

SCPI, Command Types

Device-specific, command or query

 

Example:

HCOP:ITEM:ALL

Select the complete information to be printed.

HCOP:ITEM:TIME ON; HCOP

Include the data and time in the printed output and start printing .

 

HCOPy:PAGE:MARGin:BOTTom <numeric_value>

Defines the distance between the bottom of the page and the bottom of the printed information.  

<numeric_value>

Lower margin.

Range [def. unit]

0.01 mm to 10000 mm [mm]

*RST value

0.01 mm

 

SCPI, Command Types

Device-specific, command or query

 

Example:

HCOP:PAGE:MARG:BOTT 10; TOP 10

Set an upper and a lower margin of 1 cm.

 

HCOPy:PAGE:MARGin:LEFT <numeric_value>

Defines the distance between the left edge of the page and the left edge of the printed information.

<numeric_value>

Left margin.

Range [def. unit]

0.01 mm to 10000 mm [mm]

*RST value

0.01 mm

 

SCPI, Command Types

Device-specific, command or query

 

Example:

HCOP:PAGE:MARG:LEFT 10; RIGHT 10

Set an left and a right margin of 1 cm.

 

HCOPy:PAGE:MARGin:RIGHt <numeric_value>

Defines the distance between the right edge of the page and the right edge of the printed information.

<numeric_value>

Right margin.

Range [def. unit]

0.01 mm to 10000 mm [mm]

*RST value

0.01 mm

 

SCPI, Command Types

Device-specific, command or query

 

Example:

HCOP:PAGE:MARG:LEFT 10; RIGHT 10

Set an left and a right margin of 1 cm.

 

HCOPy:PAGE:MARGin:TOP <numeric_value>

Defines the distance between the top of the page and the top of the printed information.

<numeric_value>

Upper margin.

Range [def. unit]

0.01 mm to 10000 mm [mm]

*RST value

0.01 mm

 

SCPI, Command Types

Device-specific, command or query

 

Example:

HCOP:PAGE:MARG:BOTT 10; TOP 10

Set an upper and a lower margin of 1 cm.

 

HCOPy:PAGE:ORIentation
PORTrait | LANDscape

Defines the orientation of the printed page. Switching between LANDscape and PORTrait rotates the hardcopy result by 90 degrees. No other settings are changed.

PORTrait |

Short edge of the paper is the top of the page.

LANDscape

Long edge of the paper is the top of the page.

*RST value

PORTrait

 

SCPI, Command Types

Confirmed, command or query

 

Example:

HCOP:PAGE:ORI LAND; HCOP

Select landscape page orientation and start printing.

 

HCOPy:PAGE:WINDow
ACTive | ALL | SINGle

Defines the number of diagram areas per printed page.

ACTive

Print only active diagram area.

ALL |

All diagram areas are printed on one page.

SINGle

One diagram area per page.

*RST value

ALL

 

SCPI, Command Types

Confirmed, command or query

 

Example:

HCOP:PAGE:WIND SING; HCOP

Select one diagram area per page and start printing.